最新更新時(shí)間:2021.04.01 版本說明
機(jī)構(gòu)提交子商戶資料,微信支付系統(tǒng)會(huì)為每個(gè)子商戶創(chuàng)建子商戶號(hào)。
● 本接口請(qǐng)求的header需包含Idempotency-Key參數(shù),它是一個(gè)由商戶側(cè)生成的唯一key,微信服務(wù)器使用該值來識(shí)別多次重試是否為同一請(qǐng)求,該字段長(zhǎng)度64位,可包含字母和數(shù)字。
適用對(duì)象:機(jī)構(gòu)模式
請(qǐng)求URL: https://api.mch.weixin.qq.com/hk/v3/merchants
請(qǐng)求方式: POST
接口規(guī)則: https://wechatpay-api.gitbook.io/wechatpay-api-v3
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請(qǐng)求JSON傳參
參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
---|---|---|---|---|
機(jī)構(gòu)appid | sp_appid | string(32) | 是 | body機(jī)構(gòu)在微信公眾平臺(tái)申請(qǐng)服務(wù)號(hào)對(duì)應(yīng)的APPID 注意:僅適用于機(jī)構(gòu)模式 示例值:wx8888888888888888 |
機(jī)構(gòu)商戶號(hào) | sp_mchid | string(32) | 是 | body微信支付分配的機(jī)構(gòu)商戶號(hào) 注意:僅適用于機(jī)構(gòu)模式 示例值:3200000001 |
子商戶全稱 | name | string(128) | 是 | body子商戶公司注冊(cè)的名稱 示例值:Merchant name |
子商戶簡(jiǎn)稱 | shortname | string(64) | 是 | body子商戶簡(jiǎn)稱,用于微信訂單詳情和支付成功頁展示 示例值:Merchant shortname |
公司電話 | office_phone | string(32) | 是 | body公司電話 示例值:075586010000 |
+ 聯(lián)系人信息 | contact | object | 是 | body聯(lián)系人信息,詳細(xì)說明見 |
類目 | business_category | int | 是 | body參考附錄,詳見商業(yè)類目列表 示例值:644 |
渠道號(hào) | channel_id | string(20) | 否 | body機(jī)構(gòu)在微信商戶管理后臺(tái)創(chuàng)建的渠道號(hào),如有渠道號(hào)請(qǐng)?zhí)顚? 示例值:3200000001 |
注冊(cè)國(guó)家或區(qū)域 | merchant_country_code | string(3) | 是 | body子商戶公司注冊(cè)的國(guó)家或區(qū)域 示例值:344 |
商戶類型 | merchant_type | string(10) | 是 | body取值ENTERPRISE或INDIVIDUAL 示例值:ENTERPRISE |
公司注冊(cè)文件編號(hào) | registration_certificate_number | string(50) | 是/否 | body公司注冊(cè)文件編號(hào),當(dāng)商戶類型取值為ENTERPRISE時(shí)必填 示例值:5555-8888 |
公司注冊(cè)文件過期時(shí)間 | registration_certificate_date | string(10) | 是/否 | body 公司注冊(cè)文件過期時(shí)間。取值為過期的日期或取值為“PERMANENT” , “N/A”, 若取值為日期,格式為YYYY-MM-DD,比如2020-10-16。當(dāng)商戶類型為ENTERPRISE時(shí)必填。 示例值:2020-10-16 |
公司注冊(cè)文件照片 | registration_certificate_copy | string(128) | 否 | body公司注冊(cè)文件的照片,取值為《上傳圖片API(For HK)》返回的media ID. 示例值:w7yQFawBtja5uEdm_aoGhHuxkrIaqB4GzPCeo963zXKcO2hDVD8AjXIpgrj-x95m5iclsanHYauUt1__DsWXok2NqRliv2SDL42QoEmHIPs |
子商戶銀行結(jié)算賬戶信息 | settlement_bank_number | string(128) | 否 | body子商戶的結(jié)算銀行賬戶信息 示例值:555588889999 |
+ 業(yè)務(wù)信息 | business | object | 是 | body業(yè)務(wù)信息,具體請(qǐng)參考business對(duì)象列表 |
+ 董事信息 | director | object | 是/否 | body董事信息,當(dāng)商戶類型為ENTERPRISE必傳,具體請(qǐng)參考director對(duì)象列表 |
+ 負(fù)責(zé)人信息 | principal | object | 是/否 | body負(fù)責(zé)人信息,當(dāng)商戶類型為INDIVIDUAL必傳,具體請(qǐng)參考principal對(duì)象列表 |
對(duì)于包含了敏感信息的參數(shù),如聯(lián)系方式等,我們?cè)黾恿恕白侄渭用堋钡陌踩珯C(jī)制,保護(hù)敏感信息只能被數(shù)據(jù)的接收方看到。
加密步驟:
1、獲取微信支付平臺(tái)證書和對(duì)應(yīng)的平臺(tái)證書序列號(hào),獲取微信支付平臺(tái)證書。 本接口請(qǐng)求http頭的“Wechatpay-Serial”需要傳平臺(tái)證書序列號(hào)。
2、使用微信支付平臺(tái)證書的公鑰,對(duì)于需要加密的參數(shù)值進(jìn)行RSA加密。Java語言的加密方法的填充方案使用 RSA/ECB/PKCS1Padding ;PHP語言填充方案為 不填充。
3、加密后的密文,使用base64編碼后,作為請(qǐng)求中相應(yīng)參數(shù)的值。
{
"sp_appid": "wx82ec4jy334ner1",
"sp_mchid": "2422128905",
"name": "testname",
"shortname": "shortname",
"office_phone": "13680534111",
"contact": {
"email": "gP32/1QSaIpKlaFbWgP3hr8W3+YTtiavMRbOJJ6dATymJzxx/b4YPOTKdeRApW6Nt2ZZB9reZ1x45XhIEF/Ztb6mqfFVb6LxpJlHgDL/zpUG51551XQ3Ww+/kVCJcokiIiT1bSwEcCe6tPL2cmdsOEjlTikyrasLc1bG8vaG/i361r0vX9w56O2Mgv3OnJ4fr4xnmxNcVrJnk1f/gBSIiCUWA0163f3LM4KifQelEuz/WtroeKAzRDiI0/pOvXfwrYDK==",
"name": "Vxjsrod2RT2aGxeI5i+Z2C4arXYGXZuwE8IrRf6uYu6S5dy4Igw7kjvYWYCNfsgcdXyfjdA4KVntbgSa3zic+ERsOd5u+SNKkaFSH3SwYtpcCyaUMvICTw/6AOY/qy+He9la/gxObgi4zkxvLJmZTJVualTVJWWCIvcuDArW8Kfqp8rBl+IxDEgCojoEmqE7ymVReslGBXWiaPS1UsZx1QJyez3/ijzBa4AKch3XuPx6d3qvM+J8iMx/b94LAfpTihU/j==",
"phone": "l8JH2dAGLNJ8P5DENoMV0eW4JgIquV2ZO4conHnZp48g/eVpgvIfMj4Ge6LRVENW4eZksErJnYCQB+EOFEGR0lMhA1LexPLu0en08iM2ghkftYWAsOD4JPkvvc36SAfWal29eoZh4maO6kOGW7G4uBua6JoMsEjR6uuw5Gw5DC2eikcdkDBGk9vHSP/oxRs3Qu8a83GikhLgdpAPitXbZX/TEPG5SUg8Fx4BCMCKOfxy8uakq2/EeCtyBMjaiheUePoA=="
},
"business_category": 343,
"merchant_country_code": "344",
"merchant_type": "ENTERPRISE",
"registration_certificate_number": "519723407213085723",
"registration_certificate_date": "2022-06-03",
"settlement_bank_number": "559304578245298347923856",
"business": {
"business_type": "ONLINE",
"mcc": "5344",
"mini_program": "flowerplus"
},
"director": {
"name": "Tom",
"number": "1234567890"
}
}
參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
---|---|---|---|---|
子商戶號(hào) | sub_mchid | string(32) | 是 | 微信支付分配的子商戶號(hào) 注意:僅適用于機(jī)構(gòu)模式 示例值:1900000109 |
驗(yàn)證狀態(tài) | verification_status | string(32) | 否 | 驗(yàn)證狀態(tài): Under Review:審核中 Approved:已批準(zhǔn) 示例值:Under Review |
驗(yàn)證狀態(tài)描述 | description | string(128) | 否 | 審核狀態(tài)描述。
示例值:該子商戶需要通過審核才可生效。請(qǐng)登錄商戶平臺(tái)檢查審核狀態(tài)。 |
參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
---|---|---|---|---|
返回狀態(tài)碼 | code | string(32) | 是 | 錯(cuò)誤碼,枚舉值見錯(cuò)誤碼列表 示例值:INVALID_REQUEST |
返回信息 | message | string(256) | 是 | 返回信息,如非空,為錯(cuò)誤原因 示例值:參數(shù)格式校驗(yàn)錯(cuò)誤 |
+ 詳細(xì)的錯(cuò)誤描述 | detail | object | 否 | 當(dāng)code為PARAM_ERROR時(shí)返回,詳細(xì)說明見下 |
錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|
PARAM_ERROR | 請(qǐng)求參數(shù)未按指引進(jìn)行填寫 | 具體參數(shù)格式可以查看文檔 |
SYSTEM_ERROR | 后臺(tái)系統(tǒng)返回錯(cuò)誤 | 系統(tǒng)異常,請(qǐng)使用原參數(shù)重新發(fā)起 |
INVALID_REQUEST | 商戶系統(tǒng)異常導(dǎo)致,商戶權(quán)限異常、重復(fù)請(qǐng)求支付、證書錯(cuò)誤、頻率限制、商戶號(hào)不存在、appid和mchid不存在綁定關(guān)系、渠道號(hào)不對(duì)等 | 請(qǐng)根據(jù)接口返回的詳細(xì)錯(cuò)誤描述信息檢查您的程序,具體可以查詢detail 字段返回的詳細(xì)信息 |
INVALID_REQUEST | 沒有api創(chuàng)建子商戶的權(quán)限 | ?請(qǐng)登錄商戶管理后臺(tái)人工錄入子商戶信息 |
INVALID_REQUEST | 商戶唯一標(biāo)識(shí)已經(jīng)存在,請(qǐng)更換 | 針對(duì)不同的子商戶,請(qǐng)定義唯一的標(biāo)識(shí) |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP證